home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / 21ripl.zip / README < prev    next >
Text File  |  1993-03-15  |  26KB  |  634 lines
  1.  
  2.  
  3.  
  4.                     REMOTE IPL SUPPORT FOR OS/2 2.1
  5.  
  6.  
  7.    INTRODUCTION
  8.    ------------
  9.  
  10.    OS/2 2.1 implements several system changes that require significant
  11.    changes to the LAN Server Remoteboot service.  This document describes
  12.    how to install the LAN Server upgrades, how to update the Remote
  13.    IPL (RIPL) client definitions for different display types, and how
  14.    to support multiple versions of the OS/2 operating system in the
  15.    RIPL directory structure.  Know problems are also described.
  16.  
  17.    LAN Server 2.0 or LAN Server 3.0 with the OS/2 Remote IPL service
  18.    must already be installed before applying these updates.  Updates
  19.    are provided for both LAN Server 2.0 and 3.0.  The following files
  20.    are provided on the Remote IPL Service diskette:
  21.  
  22.      - RPLMIG21.CMD        Installation/migration procedure
  23.      - IBMLS.ZIP           Updates common to LAN Server 2.0 and 3.0
  24.      - IBMLS20.ZIP         Updates specific to LAN Server 2.0
  25.      - IBMLS30.ZIP         Updates specific to LAN Server 3.0
  26.      - OS2.ZIP             Special OS/2 2.1 utilities
  27.  
  28.  
  29.  
  30.  
  31.    VALID OS/2 / REMOTE IPL CONFIGURATIONS
  32.    --------------------------------------
  33.  
  34.    The following table identifies valid OS/2 / Remote IPL configurations:
  35.  
  36.      ┌──────────┬───────────────────────────────────────────────────┐
  37.      │ Server   │          Operating System to be RIPLed            │
  38.      │ Operating│                       2.0+                        │
  39.      │ System   │   1.3.2     2.0    Service Pak   2.00.1      2.1  │
  40.      ├──────────┼──────────┼───────┼─────────────┼─────────┼────────┤
  41.      │ 1.3.2    │   Yes    │  Yes  │    Yes      │   Yes   │   Yes  │
  42.      │          │          │       │             │         │        │
  43.      │  2.x     │    No    │  Yes  │    Yes      │   Yes   │   Yes  │
  44.      └──────────┴──────────┴───────┴─────────────┴─────────┴────────┘
  45.  
  46.  
  47.  
  48.  
  49.    LAN SERVER REMOTE IPL SERVICE UPGRADES
  50.    --------------------------------------
  51.  
  52.    The following changes/additions have been made to Remote IPL:
  53.  
  54.       - A new rexx procedure, RPLMIG21.CMD, has been provided to install
  55.         the new Remote IPL support for OS/2 2.1.
  56.  
  57.       - GETRPL.EXE and RPLUPINI.EXE (LAN Server 3.0 only) have been
  58.         updated to support the new INI file format implemented in OS/2 2.1.
  59.  
  60.       - The Full Screen interface was updated to default the 'File Index
  61.         Table to model' parameter to DEFALT21.FIT when a OS/2 2.1 server
  62.         record is selected.  Changes were also made to remove the 'Read'
  63.         attribute on OS/2 2.1 client INI files before attempting to
  64.         delete them.  The client file AUTOEXEC.20 is updated to reflect
  65.         the boot drive id.
  66.  
  67.       - The RPLSETD.CMD rexx procedure has been updated to support
  68.         OS/2 versions 2.0, 2.0 + Service Pak, 2.00.1 (Preload), and 2.1.
  69.         RPLSETD.CMD has been moved from the \IBMLAN\RPL directory to
  70.         the \IBMLAN\NETPROG directory.  The old RPLSETD.CMD in the
  71.         RPL directory is renamed to RPLSETD.OLD.
  72.  
  73.       - A new utility, RPLRXUTL.EXE, has been added to support the
  74.         new RPLSETD.CMD procedure.
  75.  
  76.       - Default WINOS2 INI files are provided that are preconfigured
  77.         for VGA display support.  XGA support statements are also
  78.         present but commented out.
  79.  
  80.  
  81.  
  82.  
  83.    KNOWN PROBLEMS
  84.    --------------
  85.  
  86.    1. All RIPL clients will Trap E while booting. There is a simple
  87.       workaround. Before RIPLing any 2.1 clients rename the file
  88.       \IBMLAN\RPL\OS2.21\OS2\DLL\TCP.DLL to TCP.BAK.
  89.  
  90.       This workaround does disable support for the touch displays.  RIPL
  91.       clients will not be able to use the touch display support.
  92.  
  93.    2. RIPL clients may also trap or hang when doing a Shutdown or
  94.       Ctrl+Alt+Del.  However, if this occurs, the client should reboot
  95.       without problems after powering off an back on.
  96.  
  97.    3. Medialess RIPL clients will Trap D if they attempt to access a
  98.       VDISK.
  99.  
  100.  
  101.  
  102.  
  103.    UPGRADING EXISTING REMOTE IPL SERVERS
  104.    -------------------------------------
  105.  
  106.    To upgrade existing RIPL servers, use the following procedure:
  107.  
  108.       1. Install Remote IPL upgrades.  Refer to the section 'INSTALLING
  109.          NEW REMOTE IPL SERVERS' for information on installing the
  110.          upgrades.
  111.  
  112.       2. Determine if the prior versions of OS/2 in the RIPL tree are
  113.          still required.  If they are not required, delete the appropriate
  114.          OS2.20 or OS2.20a directory tree to recovery the hardfile space.
  115.  
  116.       3. Use the OS/2 2.1 utility RIPLINST to install the OS/2 2.1 code.
  117.          Refer to the section 'OS/2 2.1 RIPLINST UTILITY' for additional
  118.          information.
  119.  
  120.       4. Run the LAN Server utility GETRPL.EXE.
  121.  
  122.       5. If the server will only be RIPLing OS/2 2.1 clients, use the
  123.          RPLSETD.CMD procedure to update the client DEFALT20 to support
  124.          OS/2 2.1.  Refer to the section 'RPLSETD.CMD REXX PROCEDURE'
  125.          for information on RPLSETD.CMD.
  126.  
  127.          If the server will be supporting prior versions of OS/2 in
  128.          addition to 2.1, refer to the section 'SUPPORTING MULTIPLE LEVELS
  129.          OF THE OS/2 OPERATING SYSTEM ' for details on how to support
  130.          multiple version of OS/2.
  131.  
  132.       6. Use the RPLSETD.CMD procedure to update existing RIPL clients
  133.          that are to RIPL the OS/2 2.1 operating system.
  134.  
  135.       7. If you have any customized workplace shell OS2 INI files, refer
  136.          to the section 'UPDATING MASTER WORKPLACE SHELL OS2.INI FILES'
  137.          for additional information.
  138.  
  139.       8. Review the section 'CNVTINI.EXE UTILITY' concerning INI file
  140.          restrictions when supporting multiple OS/2 operating systems.
  141.  
  142.  
  143.  
  144.  
  145.    INSTALLING NEW REMOTE IPL SERVERS
  146.    ---------------------------------
  147.  
  148.    To install new RIPL servers, use the following procedure:
  149.  
  150.       1. Install the LAN Server as described in the LAN Server documentation.
  151.  
  152.       2. Follow the procedure described above for upgrading Remote IPL
  153.          servers.
  154.  
  155.       3. If you plan to support multiple versions of OS/2 in the RIPL
  156.          tree, refer to the section 'SUPPORTING MULTIPLE LEVELS OF THE
  157.          OS/2 OPERATING SYSTEM ' for additional information.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.    INSTALLATION OF LAN SERVER REMOTE IPL UPGRADES
  164.    ----------------------------------------------
  165.  
  166.    The LAN Server Remote IPL upgrades are provided on a LAN Server Remote
  167.    IPL Service diskette.  A rexx procedure, RPLMIG21.CMD, is provided
  168.    that will install the LAN Server upgrades.  The upgrades can be installed
  169.    from the diskette or the upgrades can be copied to a hardfile and
  170.    installed from the hardfile.
  171.  
  172.    The RPLMIG21.CMD procedure performs the following functions:
  173.  
  174.       1. Creates new RIPL subdirectories to support OS/2 2.1.
  175.  
  176.       2. Copies several master files from the RIPL OS/2 2.0 directories
  177.          into the new RIPL OS/2 2.1 directories.
  178.  
  179.       3. Installs the LAN Server upgrade files to the appropriate
  180.          directories.  RPLMIG21 will determine which version of LAN
  181.          Server is installed and copy the appropriate update files.
  182.  
  183.       4. Upgrades the RPL.MAP file to add server records to
  184.          support OS/2 2.1.
  185.  
  186.       5. Creates OS221*.CNF files to support the server records
  187.          created in step 4.
  188.  
  189.       6. Update the server name references in the DEFALT21.FIT file
  190.          installed as part of step 3.
  191.  
  192.       7. Update the master CONFIGRI.20 files to add the
  193.          DEVICE=Z:\OS2\TESTCFG.SYS statement required for OS/2 2.1
  194.          remote install.
  195.  
  196.       Note: RPLMIG21.CMD creates a file called \IBMLAN\RPL\RPLMIG21.$$$
  197.             which is 'Read-only'.  If RPLMIG21.CMD detects that this
  198.             file is already present, it will exit without installing
  199.             any updates.  If for some reason you wish to rerun
  200.             RPLMIG21.CMD, you must first delete RPLMIG21.$$$.  The
  201.             procedure RPLSETD.CMD will not execute if the RPLMIG21.$$$
  202.             file is not present.
  203.  
  204.  
  205.    To install from the diskette, do the following:
  206.  
  207.       1. Insert the diskette in drive A.
  208.  
  209.       2. At an OS/2 prompt, enter the following command
  210.  
  211.          A:\RPLMIG21
  212.  
  213.  
  214.    To install from a hardfile, do the following:
  215.  
  216.       1. Create a subdirectory, for example d:\RPLOS221.
  217.  
  218.       2. Copy the files on the RIPL Service diskette to the
  219.          subdirectory created in step 1.
  220.  
  221.       3. At a OS/2 prompt, enter the command:
  222.  
  223.          d:\RPLOS221\RPLMIG21 /S:d:\RPLOS221
  224.  
  225.          The /S parameter specifies the path to the directory
  226.          created in step 1.
  227.  
  228.  
  229.    The complete syntax for the RPLMIG21.CMD procedure is given below:
  230.  
  231.    RPLMIG21.CMD  [ ? | /h | /H] [/S:Sourcepath] [/L:Logfile]
  232.  
  233.        where ? or /h or /H is a request for this help panel.  If specified,
  234.                it must be first parameter.
  235.  
  236.              /S:Sourcepath is the fully qualified path to the directory
  237.                 which contains the files to be installed by RPLMIG21.  The
  238.                 default value is A:\.
  239.  
  240.              /L:Logfile is the fully qualified name of a file to which all
  241.                 messages and errors are to be logged.  If Logfile is specified,
  242.                 no messages or errors will be displayed on the screen.
  243.  
  244.  
  245.  
  246.  
  247.    OS/2 2.1 RIPLINST UTILITY
  248.    -------------------------
  249.  
  250.    The RIPLINST utility used to install the OS/2 2.1 code for LAN Server
  251.    OS/2 Remote IPL is located (in packed format) on diskette 7 of the
  252.    OS/2 2.1 Installation diskettes.  Refer to the LAN Server documentation
  253.    for information on installing and running the RIPLINST utility.
  254.  
  255.    Previous versions of RIPLINST had a default target install directory of:
  256.  
  257.      d:\IBMLAN\RPL\OS2.20  (OS/2 2.0)
  258.  
  259.      or
  260.  
  261.      d:\IBMLAN\RPL\OS2.20a (Service Pack)
  262.  
  263.    (The drive letter d indicates the drive where OS/2 is installed.)
  264.  
  265.    The RIPLINST for OS/2 2.1 has a new default target install directory. The
  266.    new default target install directory is:
  267.  
  268.      d:\IBMLAN\RPL\OS2.21
  269.  
  270.    This was done so that an existing ..\OS2.20 directory tree would not be
  271.    automatically overwritten.  If you wish to upgrade an existing ..\OS2.20
  272.    directory tree, the target install directory must be updated before
  273.    starting the install process.  The target directory must be on the same
  274.    drive where OS/2 Remote IPL was installed (this can be different from
  275.    where LAN Server is installed).
  276.  
  277.    After using RIPLINST to install OS/2 2.1 for Remote IPL, the updated
  278.    version of the LAN Server utility, GETRPL.EXE, must be run.  Refer to
  279.    the LAN Server documentation for information on running GETRPL.
  280.  
  281.  
  282.  
  283.  
  284.    RPLSETD.CMD REXX PROCEDURE
  285.    --------------------------
  286.  
  287.    The RPLSETD.CMD procedure provides the following functions:
  288.  
  289.       - Upgrade existing RIPL clients that use 16 bit display drivers
  290.         to use the new 32 bit VGA and XGA display drivers or the 16
  291.         bit 8514 driver provided in OS/2 2.00.1, 2.0 + Service Pak,
  292.         and 2.1.
  293.  
  294.       - Can be used to change the display type (32 bit VGA/XGA or
  295.         16 bit 8514) that a RIPL client is using.  RPLSETD does not
  296.         support converting from the new drivers back to the old 16
  297.         bit display drivers.
  298.  
  299.       - Can be used to update a RIPL client to boot a different
  300.         version of OS/2 2.x.  The OS/2 2.x code must be installed
  301.         in the RIPL directory structure.  The following OS/2 2.x
  302.         versions conversions are supported:
  303.  
  304.            old version      new version
  305.                2.0             2.00.1
  306.                                2.0+Service Pak
  307.                                2.1
  308.  
  309.               2.00.1           2.0+Service Pak
  310.                                2.1
  311.  
  312.            2.0+Service Pak     2.00.1
  313.                                2.1
  314.  
  315.         Note that there is no support for converting any of the newer
  316.         versions back to the original OS/2 2.0.
  317.  
  318.    Client definitions can be updated individually or in a group (grouped by
  319.    display type and operating system).
  320.  
  321.    The client name DEFALT20 is a special client name used by the OS/2
  322.    Remote IPL support as a default when creating a new client (not
  323.    modelling an existing client). If you are supporting prior versions
  324.    of OS/2 (i.e. 2.0, 2.00.1, or 2.0 + Service Pack) in the RIPL directory
  325.    tree, do not update DEFALT20 to support OS/2 2.1.  You must leave
  326.    DEFALT20 at its current level to support the prior version(s) of OS/2.
  327.    To support OS/2 2.1 RIPL clients do the following:
  328.  
  329.      - Create a 'new' RIPL client, for example, MODEL21, using the defaults.
  330.      - Use RPLSETD to update MODEL21 to support OS/2 2.1.  Then use MODEL21
  331.        as a model client to create all future 2.1 clients.
  332.      - You may need to create multiple 2.1 models, one for each LAN type you
  333.        support.
  334.  
  335.    If the only version of OS/2 that will be installed in the RIPL directory
  336.    tree is OS/2 2.1, you should update the client DEFALT20.  Then all future
  337.    default clients will automatically support OS/2 2.1.  Normally RPLSETD
  338.    only updates four client files and in some cases RPL.MAP; however,
  339.    DEFALT20, is a special case and ten files will be updated.
  340.  
  341.  
  342.    The syntax of RPLSETD.CMD is:
  343.  
  344.      RPLSETD  [/H] [/D:DISPLAY_DRIVER  /C:CLIENT[,CLIENT2,CLIENT3,...] ]
  345.               [/O:CURRENT_OS2] [/N:NEW_OS2] [/L:LOGFILE] [/R:RESPONSE_FILE]
  346.  
  347.      where:
  348.  
  349.      /H
  350.         displays the syntax on screen.  If specified, it must be the first
  351.         parameter.
  352.  
  353.      /D:DISPLAY_DRIVER (DISPLAYDRIVER)
  354.         is the new display type for the client definition.  The following
  355.         display types are valid:
  356.  
  357.             IBMVGA32    32-bit VGA display driver
  358.             IBMXGA32    32-bit XGA display driver
  359.             IBM8514     16-bit 8514 display driver
  360.  
  361.      /C:CLIENT[,CLIENT2,CLIENT3,...]  (CLIENT or CLIENTLIST)
  362.         is the name of one or more OS/2 remote IPL client workstations
  363.         that are to be updated to support the specified display driver.
  364.         If multiple client names are specified, each client name must be
  365.         separated with a comma.  Imbedded blanks are not allowed.
  366.         The response file keywords CLIENT and CLIENTLIST are equivalent
  367.         to each other.  They may be specified as many times times as
  368.         necessary.
  369.  
  370.      /O:CURRENT_OS2 (CURRENTOS2DIR)
  371.         is the root directory under \IBMLAN\RPL for the current version of
  372.         OS/2 2.0 that the client is using.  This parameter is case sensitive.
  373.         The default is OS2.20.  The /O and/or /N parameters should only be
  374.         specified when you need to switch a client from one OS version to
  375.         another OS version.
  376.  
  377.      /N:NEW_OS2 (NEWOS2DIR)
  378.         is the root directory under \IBMLAN\RPL for the version of OS/2 2.0
  379.         that the client is to be switched to.  This parameter is case
  380.         sensitive.  The default is OS2.21.  The /O and/or /N parameters
  381.         should only be specified when you need to switch a client from one
  382.         OS version to another OS version.
  383.  
  384.      /L:LOGFILE (LOGFILE)
  385.         is the drive, path, and filename of a file to which all messages and
  386.         errors are to be logged.  If this parameter is specified, the only
  387.         errors displayed on the screen will be for a failure to open the
  388.         logfile or for missing required parameters in the response file.
  389.  
  390.      /R:RESPONSE_FILE
  391.         is the drive, path, and filename of a file that contains the command
  392.         inputs in keyword form (keyword=value).  The valid keywords are
  393.         indicated above in () following each /X: syntax.  Only one keyword
  394.         can be specified per line in the response file.  The DISPLAYDRIVER,
  395.         CLIENT or CLIENTLIST, and LOGFILE parameters are required when using
  396.         a response file.  If the /R parameter is specified, all other
  397.         parameters specified on the command line are ignored.
  398.  
  399.    Since the new default target directory for OS/2 2.1 is ..\OS2.21, it will
  400.    be necessary to specify the parameter /N:OS2.21 on each invokation of
  401.    RPLSETD. The /O parameter only has to be specified if the user has used a
  402.    directory other than ..\OS2.20 to install previous version of the OS/2 2.0
  403.    code.
  404.  
  405.    Examples:
  406.  
  407.      -  To update the DEFALT20 client to use the 32 bit VGA display driver
  408.         and switch the operating system from OS2.20 to OS2.21, type:
  409.  
  410.         RPLSETD /D:IBMVGA32 /C:DEFALT20 /N:OS2.21
  411.  
  412.         This will update the default files to support OS/2 2.1 and the new
  413.         VGA display driver.  These files are used when defining clients using
  414.         the default configuration.
  415.  
  416.         Note: If you plan to also support previous versions of OS/2 (i.e.
  417.               2.0, 2.00.1, or 2.0 + Service Pak), do not update the DEFALT20
  418.               client.
  419.  
  420.      -  To update the MACH001 client to use the 32 bit XGA display driver
  421.         and switch the operating system from OS2.20 to OS2.21, type:
  422.  
  423.           RPLSETD /D:IBMXGA32 /C:MACH001 /N:OS2.21
  424.  
  425.      -  To update the MACH001 client to use the 32 bit XGA display driver
  426.         and switch the operating system from OS2.20a to OS2.21, type:
  427.  
  428.           RPLSETD /D:IBMXGA32 /C:MACH001 /O:OS2.20a /N:OS2.21
  429.  
  430.      -  To update multiple clients, MACH001 and MACH002, to use the 32 bit
  431.         VGA display driver and switch the operating system from OS2.20 to
  432.         OS2.21, type:
  433.  
  434.           RPLSETD /D:IBMVGA32 /C:MACH001,MACH002 /N:OS2.21
  435.  
  436.      -  To use the response file option, do the following:
  437.  
  438.           1. Create an ASCII file that contains the appropriate keyword
  439.              values. For example:
  440.  
  441.              DISPLAYDRIVER=IBMVGA32
  442.              CLIENT=DEFALT20
  443.              CLIENT=MACH001,MACH002
  444.              CLIENTLIST=MACH003,MACH004
  445.              CURRENTOS2DIR=OS2.20
  446.              NEWOS2DIR=OS2.21
  447.  
  448.              Note that CLIENT and CLIENTLIST are equivalent and that multiple
  449.              entries can be specified on either.
  450.  
  451.           2. Type the following command:
  452.  
  453.              RPLSETD /R:d:\path\response_filename
  454.  
  455.  
  456.  
  457.  
  458.    CREATING NEW OS/2 2.1 RIPL CLIENTS
  459.    ----------------------------------
  460.  
  461.    The menu interface has been updated to automatically select the
  462.    FITS\DEFALT21.FIT entry when a 'NEW' client is created using an
  463.    OS/2 2.1 server record id.  However, the master CONFIG.20 files
  464.    have not been updated to OS/2 2.1 level so that back level versions
  465.    of OS/2 can also be supported.
  466.  
  467.    The differences between an OS/2 2.0 and OS/2 2.1 CONFIG.20 file
  468.    are minor, mainly new SET statements.  In most cases the CONFIG.20
  469.    file will work for OS/2 2.1 as is.  However, if you wish to convert
  470.    the client CONFIG.20 to the OS/2 2.1 level, run the RPLSETD command
  471.    against the client.  RPLSETD will update the CONFIG.20 file to the
  472.    OS/2 2.1 level.
  473.  
  474.    A new client created using the defaults, will be configured to
  475.    support the IBMVGA32 display drivers.  If the client has an XGA
  476.    or 8514 display attached, RPLSETD must be run against the client
  477.    to reconfigure the client for the correct display type.
  478.  
  479.  
  480.  
  481.  
  482.  
  483.    UPDATING MASTER WORKPLACE SHELL OS2.INI FILES
  484.    ---------------------------------------------
  485.  
  486.    Some users have a master customized OS2.INI file that is copied to the
  487.    client directory each time the client is remote booted.  This master file
  488.    must also be update to identify the type of display driver that the client
  489.    workstation is using.  Clients with different display types (i.e. vga,
  490.    xga, 8514) MUST use different master OS2.INI files.
  491.  
  492.    To update a master OS2.INI file, enter the following command:
  493.  
  494.       RPLRXUTL  /D:DISPLAY_DRIVER  /C:INI_FILENAME
  495.  
  496.       where:
  497.  
  498.       /D:DISPLAY_DRIVER
  499.          is the same as for RPLSETD.
  500.  
  501.       /C:INI_FILENAME
  502.          is the drive, path, and filename of the master OS2.INI file to be
  503.          updated.
  504.  
  505.    For example:
  506.  
  507.      RPLRXUTL /D:IBMVGA32 /C:E:\IBMLAN\RPL\MASTER\VGAOS2.INI
  508.  
  509.    The RPLRXUTL utility will not display any error information.  It does
  510.    return with a non-zero return code if there was an error.  If you need
  511.    to verify error information, invoke RPLRXUTL from a CMD procedure (batch
  512.    file or Rexx) so that the return code can be tested.
  513.  
  514.    WARNING: If the LAN Server is running on a OS/2 2.1 system, the format
  515.             of the INI file will be automatically converted to the new 2.1
  516.             format.  If the INI file will be used by a RIPL client that
  517.             is booting a previous level of OS/2 (2.0, 2.00.1, or Service
  518.             Pak), a new OS/2 2.1 utility, CNVTINI.EXE, must be used to
  519.             convert the INI file back to the old format.
  520.  
  521.  
  522.  
  523.  
  524.    CNVTINI.EXE UTILITY
  525.    -------------------
  526.  
  527.    The format of OS/2 INI files has been changed with the OS/2 2.1
  528.    operating system.  This new format is incompatabile with previous
  529.    versions of OS/2.  Old format INI files are automatically converted
  530.    to the new format by OS/2 2.1.  However, in the RIPL environment,
  531.    there is a requirement to convert new format INI files back to the
  532.    old format (needed to support previous OS/2 versions on a RIPL server
  533.    that is running on OS/2 2.1).  OS/2 2.1 provides a special utility,
  534.    CNVTINI.EXE, that converts a new format INI file to the old format.
  535.    This utility is temporarily being provided on the RIPL Support
  536.    diskette and is installed in the \IBMLAN\RPL\OS2.21\OS2 directory.
  537.    It is expected that in the final OS/2 2.1 product, this utility
  538.    will be shipped with OS/2 2.1.
  539.  
  540.    If the RIPL server is running on a OS/2 2.1 system and the RPLRXUTL
  541.    utility is used to update the INI file of a RIPL client that will
  542.    be booting a previous level of OS/2, the CNVTINI utility MUST be
  543.    used to convert the updated INI file back to the old format.
  544.  
  545.    To convert a new format INI file to the old format, enter the
  546.    command:
  547.  
  548.      CNVTINI d:\path\INI_filename
  549.  
  550.        where d:\path\INI_filename is the fully qualified name of the
  551.                                   INI file to be converted to the old
  552.                                   format.
  553.  
  554.    Any utility program which uses the PRF API interface to open an INI
  555.    file under OS/2 2.1 will cause that INI file to be automatically
  556.    converted to the new format.  Utilities which display the contents
  557.    of INI files will fall in this category.  If a RIPL client booting
  558.    a previous version of OS/2 then tries to use that INI file, it will
  559.    fail because the format of the INI file is invalid.  The CNVTINI
  560.    utility must be used to convert the INI file back to the old format
  561.    before it can be used by a previous level of OS/2.
  562.  
  563.  
  564.  
  565.  
  566.    SUPPORTING MULTIPLE LEVELS OF THE OS/2 OPERATING SYSTEM
  567.    -------------------------------------------------------
  568.  
  569.    It is possible to install and support multiple levels of the OS/2
  570.    2.x operating system on a RIPL server.  This section documents the
  571.    correct procedure to use to support such an environment.  It is
  572.    assumned that the OS/2 2.1 Remote IPL Support updates have already
  573.    been installed.
  574.  
  575.    The basic procedure is as follows:
  576.  
  577.      1. Run the OS/2 utility RIPLINST to install the OS/2 code in
  578.         the RIPL directory tree.  You must be carefully to use the
  579.         version of RIPLINST that matches the level of code to be
  580.         installed.  RIPLINST is located on diskette 7 of all
  581.         OS/2 2.x installation diskettes.  RIPLINST is unique for
  582.         each version of OS/2.
  583.  
  584.      2. After running RIPLINST, run the LAN Server utility, GETRPL.
  585.         GETRPL uses information stored in the OS2SYS.INI file by
  586.         RIPLINST so it is very important that GETRPL be run
  587.         before using RIPLINST to install another version of OS/2.
  588.  
  589.      3. Repeat steps 1 and 2 for each version of OS/2 that will be
  590.         RIPLed.
  591.  
  592.      4. Determine whether the special RIPL client, DEFALT20, should
  593.         be updated by RPLSETD.  This depends on what OS/2 versions
  594.         are installed.
  595.  
  596.         OS/2 version 2.0 uses 16 bit display drivers.  OS/2 versions
  597.         2.00.1, 2.0+Service Pak, and 2.1 use 32 bit display drivers
  598.         for VGA and XGA support.  However, there are slight differences
  599.         in the XGA support between 2.00.1 and 2.0+Service Pak/2.1.
  600.  
  601.         If OS/2 2.0 is present, DEFALT20 must not be updated.  It
  602.         must remain as is to allow the creation of future 2.0 clients.
  603.  
  604.         If OS/2 2.0 is not present, then DEFALT20 could be updated
  605.         with RPLSETD to support either 2.00.1 or 2.0+Service Pak/2.1.
  606.         To update DEFALT20 to support 2.0+Service Pack, enter the command:
  607.  
  608.            RPLSETD /D:IBMVGA32 /C:DEFALT20
  609.  
  610.         To update DEFALT20 to support 2.00.1, enter the command:
  611.  
  612.            RPLSETD /D:IBMVGA32 /C:DEFALT20 /N:OS2.20a
  613.  
  614.         The /N parameter indicates that the new default target operating
  615.         system will be \IBMLAN\RPL\OS2.20a.  The RIPLINST for OS/2 2.00.1
  616.         defaulted to a target directory of \IBMLAN\RPL\OS2.20a.
  617.  
  618.         To update DEFALT20 to support 2.1, enter the command:
  619.  
  620.            RPLSETD /D:IBMVGA32 /C:DEFALT20 /N:OS2.21
  621.  
  622.         The /N parameter indicates that the new default target operating
  623.         system will be \IBMLAN\RPL\OS2.21.  The RIPLINST for OS/2 2.1
  624.         defaults to a target directory of \IBMLAN\RPL\OS2.21.
  625.  
  626.      5. Since the special RIPL client DEFALT20 must be associated with
  627.         a specific OS/2 version, it is recommended that model clients
  628.         be created for the other OS/2 versions installed in the RIPL
  629.         tree.  RPLSETD can be used to update the model client
  630.         definitions to point to the correct operating system.  Then
  631.         these model clients can be used to create future clients for
  632.         each operating system type.
  633.  
  634.